home *** CD-ROM | disk | FTP | other *** search
/ BBS Toolkit / BBS Toolkit.iso / remote / fatt121.zip / FATTACH.DOC < prev    next >
Text File  |  1991-10-15  |  9KB  |  253 lines
  1.  
  2.  
  3.  
  4.                                 FAttach 1.20
  5.  
  6.                          Files automatically on HOLD 
  7.  
  8.                 Copyright (C) 1991 MiPA Software Development
  9.  
  10.                              FidoNet (2:240/100)
  11.                             
  12.  
  13.  
  14.         FAttach is a tool for BBS-Systems running FrontDoor with a
  15.         large amount of files. Because FrontDoor needs some time to
  16.         find the frequested files in a big system, sometimes the 
  17.         calling system hangs up before FrontDoor starts sending.
  18.  
  19.         To get around this FAttach can be used. All that is to be
  20.         done is the following type of netmail.
  21.  
  22.         ┌──────────────────────────────────────────────────────────┐
  23.         │ TO : FAttach, <Your Address>                             │
  24.         │ RE : Anything                                            │
  25.         │                                                          │
  26.         │ In the TEXT-area the names of the files to be requested  │
  27.         │                                                          │
  28.         │ TANGRAM.GIF                                              │
  29.         │ FATT111.*                                                │
  30.         │ FILES                                                    │
  31.         └──────────────────────────────────────────────────────────┘
  32.  
  33.         Multiple files & wildcards are allowed.                
  34.  
  35.         After recieving the netmail FAttach looks for a mail to it. 
  36.         Then ist ist looks through all frequestable directorys for 
  37.         the requested files, and makes a FileAttach Msg for the caller
  38.         who may then poll for his frequest.
  39.  
  40.         FAttach can be configured in the following way , so that un-
  41.         wanted "Suckers" can be closed out or let in.
  42.  
  43.  
  44.         ────────────────────────────────────────────────────────────
  45.  
  46.                         Configuration of FAttach
  47.  
  48. ;       Comments start with a ";" and are not allowed after a Keyword
  49. ;       Keywords are NOT case sensitive.
  50. ;
  51. ;       If [N] is at the beginning of a comment it means that the
  52. ;       Keyword is ESSENTIAL, if [O] it is optional. Keywords that
  53. ;       are not needed must be commented out with ";" or deleted.
  54. ;
  55. ; [N]   Sysop-Name for From: FileAttach-Mail
  56. Sysop   Mike Paschen
  57. ;
  58. ;
  59. ; [N]   Main address
  60. Address 2:240/100
  61. ;
  62. ;
  63. ; [O]   You may define several AKA's to which FAttach mail may be
  64. ;       directed.               
  65. AKA     2:240/101
  66. AKA     2:240/2000
  67. AKA     2:25163/0
  68. ;
  69. ;
  70. ; [N]   Full path to your Netmail directory, finishing '\' is optional.
  71. NetMail C:\Fido\Netmail
  72. ;
  73. ;
  74. ; [N]   List of all directorys from wich frequests are allowed.
  75. ;       One directory per line, finishing "\" is optional.
  76. FreqDir C:\Fido\Filepath.lst
  77. ;
  78. ;
  79. ; [O]   List of directorys that are PASSWORD protected, but are in
  80. ;       FreqDir. These directorys will not be seen through.
  81. NoFreq  C:\Fido\NoFreq.lst
  82. ;
  83. ;
  84. ;  [O]  List of MAGIC's, so that magic file names also can be considered.
  85. ;       One Magic name per line.
  86. ;       Syntax as Follows.
  87. ;       FILES  K:\Allfiles\22400100.arj
  88. Magic   C:\Fido\Magic.lst
  89. ;
  90. ;
  91. ; [O]   Textfile, that will be hung on to the FileAttach-Msg's.
  92. ;       For infos, finger slapping and so on.
  93. ;       If this parameter is left out and both the MsgFile und MsgSize 
  94. ;       parameters are left out then this text will allways be attached.
  95. MsgText C:\Fido\FAttach.msg
  96. ;
  97. ;
  98. ; [O]   MsgSubject defines the subject of MsgText
  99. MsgSubject  Filerequest via FAttach
  100. ;
  101. ;
  102. ; [O]   With the parameter MsgFile you can define that the textfile
  103. ;       only be sent when this amount of files are requested.
  104. MsgFile 10
  105. ;
  106. ;
  107. ; [O]   With the parameter MsgSize you can define that the textfile
  108. ;       only be sent if the filerequest reaches this kilobyte amount.
  109. MsgSize 1024
  110. ;
  111. ;
  112. ; [O]   List of nodes (one entry per line), that are allowed to
  113. ;       use FAttach. if this list is not defined everyone can use
  114. ;       it (point can be closed out using NoPoints).
  115. ;       If used only Points & Nodes in this list can use FAttach.
  116. ;
  117. ;       Only ONE or NONE of the lists may be used, because both
  118. ;       list stop the other one.
  119. NodeOk  C:\Fido\NodeOk.lst
  120. ;
  121. ;
  122. ; [O]   List of nodes (one entry per line), who are NOT allowed
  123. ;       to use FAttach. 
  124. ;       Use the same as in NodeOk.
  125. NodeBad C:\Fido\NodeBad.lst
  126. ;
  127. ;
  128. ; [O]   NoPoints is used to stop points using FAttach.
  129. ;       This is for Sysops who want to protect their files  :-)
  130. NoPoints
  131. ;
  132. ;
  133. ; [N]   Maximum amount of files per FAttach msg. If a node sends 
  134. ;       more than one message it doesn't work.
  135. MaxFiles 20
  136. ;
  137. ;
  138. ; [N]   Level 1 - Only the frequested files will be logged
  139. ;       Level 2 - All files found in a frequest will be logged.
  140. LogLevel 1
  141. ;
  142. ;
  143. ; [N]   The MailFlag specifys if the fileattach-msg's get Hold (H),
  144. ;       Direct (D) or Crash (C) flag. Be very careful with the 
  145. ;       (D) and (C) flag.
  146. ;
  147. ;       Use it only together with the NodeOk-list, because these
  148. ;       people will have the pleasure of only sending the request MSG
  149. ;       and you send the files ;-)
  150. ;
  151. ;       With several CTL-Files you can make differences, so that
  152. ;       normal nodes get Hold. And special nodes get Crash. To do
  153. ;       this FAttach must be loaded with a CTL-File as parameter.
  154. ;
  155. ;       Only one of these flags can be set.
  156. MailFlag H | D | C
  157. ;
  158. ;
  159. ; [O]   For the finger slapping MsgText you can define an origin.
  160. ;       Net address is not allowed because it will be done automatically.
  161. ;
  162. ;       If an answer is made because the file was not found this 
  163. ;       origin will be used.
  164. Origin  Filerequest via FAttach
  165. ;
  166. ;
  167. ; [O]   If FileInfo is used for every found file the description line
  168. ;       in FILES.BBS will be picked out and sent as MAIL.
  169. FileInfo
  170. ;
  171. ;
  172. ; [O]   If StopFound is set FAttach stops searching for more files
  173. ;       after one file was found and no wildcard was used. Than the
  174. ;       requester gets only the file that was found first if you have
  175. ;       several files with the same name on your system.
  176. StopFound
  177. ;
  178. ; [O]   One or more NickName's for FATTACH can be defined. You may use
  179. ;       NICKNAME fattache for the users who add an E at the end or so.
  180. ;       Using several NICKNAME <NickName> defines different NickNames
  181. NickName Fattache
  182. NickName Freq
  183.  
  184.         ────────────────────────────────────────────────────────────
  185.  
  186.         Fattach automatically identifies the path it resides in and
  187.         searches there for the CTL-file if no CTL-file is specified.
  188.  
  189.         So that FAttach can work at optimum FrontDoor should Exit
  190.         after receipt of every mail and FAttach should be started.
  191.  
  192.         In Frodo Setup under Mailer, Miscellaneous following
  193.  
  194.           ....
  195.         ▒│  Present all AKAs to remote system       Yes           │▒
  196.         ▒│  Trigger exit upon receipt of netmail    Yes           │▒
  197.         ▒│  └─Upon receipt of ANY file              Yes | No      │▒
  198.           ....
  199.  
  200.         Mail must not be tossed, only FAttach must look for mail
  201.         in the Netmail directory.
  202.  
  203.         ────────────────────────────────────────────────────────────
  204.  
  205.         If you think FAttach is good ;-) then please send me
  206.         a nice postcard with your FIDONET address.
  207.  
  208.                    MiPA Software Development GmbH
  209.                    Mike Paschen
  210.                    Hellgrundweg 109
  211.                    D-2000 Hamburg 54
  212.  
  213.  
  214.         Restrictions:
  215.  
  216.         You can define up to 4096 AKA's (do you know so many ;-) ),
  217.         4096 fileareas, 4096 unallowed nodes or 4096 allowed nodes,
  218.         4096 MAGIC names and 4096 NickName's.
  219.         
  220.  
  221.         Usage:
  222.  
  223.         FAttach may be used on Noncommercial sites free of charge.
  224.         On Commercial Sites after 21 days of trial a Registration
  225.         Fee of DM 20,- ( TWENTY GERMAN MARKS ) to be payed to the
  226.         above address.
  227.  
  228.         FAttach is NOT Public Domain Software. Sale of this program
  229.         needs the ALLOWANCE of the AUTHOR.
  230.  
  231.  
  232.         Legal Stuff:
  233.  
  234.         We guarantee only that FAttach will take up about 100 KB on
  235.         your HardDisk, and that your Logfile will get even bigger ;-)
  236.         If anything else happens it belongs to you and and nobody else.
  237.  
  238.  
  239.         Thanks to my Betatester-Team
  240.  
  241.         Bodo Matthias           (2:245/60)
  242.         Dieter Baumgartner      (2:246/15)
  243.         Matthias Mueller        (2:240/600.1)
  244.  
  245.         and thanks to Rocky Somerville (2:241/2100) for the
  246.         translation.
  247.  
  248.         ────────────────────────────────────────────────────────────
  249.  
  250.                Critics, updatewishes and stuff like that to
  251.  
  252.                     Mike Paschen, FidoNet (2:240/100)
  253.